home *** CD-ROM | disk | FTP | other *** search
/ Megahits 5 / Megahits 5 (1994)(GTI - Rhein-Main-Soft)(DE)(Disc 2 of 2)[!].iso / archive / show / superview_lib6_3.lha / superview-lib / Docs / SuperView-Lib_DEU.doc < prev    next >
Text File  |  1994-06-06  |  16KB  |  467 lines
  1.  
  2.               superview.library V6.3
  3.  
  4.                - FREEWARE -
  5.  
  6.          © 1993-94 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.           Dieses Programm wurde unter OS V3.00 geschrieben und ist
  9.           deshalb voll kompatibel. Es benötigt OS V2.04+.
  10.  
  11.           Release Datum : 06.06.1994
  12.  
  13.  
  14.     Copyright und Distribution :
  15.     ============================
  16.  
  17.     Das Programm superview.library V6.3
  18.     und seine Dokumentations-Dateien sind
  19.     (C)opyright 1993-94 by Andreas R. Kleinert. Alle Rechte vorbehalten.
  20.  
  21.     Die Verwendung der "superview.library" für eigene Programme, ob
  22.     kommerziell oder nicht-kommerziell, ist uneingeschränkt gestattet.
  23.  
  24.  
  25.     Einschränkungen :
  26.     =================
  27.  
  28.     Der Autor übernimmt keine Verantwortung für irgendeine Art von Auswir-
  29.     kungen, die durch die Nutzung dieses Programmes entstehen.
  30.     Diese Software wird zur Verfügung gestellt "WIE SIE IST" und es wird
  31.     keine Garantie irgendeiner Art übernommen, so daß Sie diese Software
  32.     auf eigenes Risiko nutzen.
  33.  
  34.  
  35.     Funktion :
  36.     ==========
  37.  
  38.     Die "superview.library" findet Verwendung in vielen von mir geschriebenen
  39.     Programmen und enthält viele Funktionen, die die Anzeige, Speicherung und
  40.     Konvertierung von diversen Bildformaten (IFF-ILBM, IFF-ACBM, PCX, ...)
  41.     sehr erleichtern.
  42.     Durch externe Viewer-Libraries (svobjects) und Grafikkartentreiber
  43.     (svdrivers) wird höchstmögliche Flexibilität und einfache Erweiterbarkeit
  44.     ermöglicht.
  45.  
  46.     Senden Sie mir einfach die von Ihnen programmierten SVObjects und
  47.     SVDrivers, falls Sie möchten, daß diese in das Haupt-Distributionsarchiv
  48.     oder auf die Developer-Disk übernommen werden sollen.
  49.  
  50.  
  51.     Installation :
  52.     ==============
  53.  
  54.     Verwenden Sie einfach das beigefügte Installer-Skript, oder kopieren
  55.     Sie per Hand die "superview.library" ins "LIBS:"-Verzeichnis, die
  56.     svobjects nach "LIBS:svobjects/" und die svdrivers nach "LIBS:svdrivers/" !
  57.  
  58.     Die "datatypes.library" V39+ wird nur benötigt, wenn die OS V3.00+
  59.     DataTypes verwendet, d.h. unterstützt, werden sollen.
  60.     Achten Sie darauf, welche Libraries außerdem noch von den einzelnen
  61.     SVObjects benötigt werden.
  62.  
  63.     "AddBuffers"-Werte für die benutzten Laufwerke sollten mindestens
  64.     25 betragen.
  65.  
  66.     Sie können die folgenden Environment-Variablen innerhalb des Directories
  67.     "ENV:superview-library" setzen. SuperViewPrefs kann dafür verwendet
  68.     werden.
  69.  
  70.     Name          Inhalt
  71.  
  72.     SVDriver.ascii      Name des Default-ScreenDrivers. Wird von der
  73.               superview-library beim ersten Öffnen gelesen.
  74.               DARF KEINE weiteren Zeichen (Spaces, Tabs, etc.)
  75.               enthalten.
  76.  
  77.  
  78.     SVObjects :
  79.     ===========
  80.  
  81.     Verfügbare SVObjects (soweit bekannt) :
  82.  
  83.      SVObject         Typ   Lesen              Schreiben
  84.  
  85.      IFF-ILBM         EXT   (system-abhängig)      (system-abhängig)
  86.      IFF-ACBM         EXT   (system-abhängig)      (system-abhängig)
  87.      OS V3.00+ DataTypes INT   alle Grafiken          -
  88.      PCX upto V3.0     EXT   bis 256 Farben          bis 256 Farben
  89.                  + 24 Bit Dateien
  90.      SVO upto V1.0     EXT   (system-abhängig)      (system-abhängig)
  91.      GIF upto 89a     EXT   bis 256 Farben          bis 256 Farben
  92.      BMP (Windows)       EXT   bis 256 Farben         bis 256 Farben
  93.      FBM (Unix)          EXT   bis 256 Farben         bis 256 Farben
  94.      C64 (Koala, Doodle) EXT   bis  16 Farben         -
  95.      IMG (GEM/Ventura)   EXT   bis 256 Graustufen     -
  96.      TIFF (V5.0)         EXT   bis 256 Farben         bis 256 Farben
  97.                  + 24 Bit Dateien
  98.      WPG (WordPerfect)   EXT   bis 256 Farben         -
  99.      MAC (MacPaint)      EXT   bis   2 Farben (S/W)   -
  100.      JPEG (JFIF)         EXT   24 Bit als 256 Farben  -
  101.                  + 24 Bit als 24 Bit
  102.  
  103.      JPEG.svobject ist in einem separaten Archiv enthalten.
  104.  
  105.     Geplante SVObjects (keine Garantie !) :
  106.  
  107.      - PC Paint/PIC
  108.      - und mehr
  109.  
  110.  
  111.     Verfügbare SVDriver (soweit bekannt) :
  112.  
  113.      SVDriver       Anforderungen       BITPLANE    ONEPLANE
  114.  
  115.      ECS       ECS / OS V2.04+ (V37)   (System)    8      Bit
  116.      AGA       AGA / OS V3.00+ (V39)   (System)    8      Bit
  117.      EGS-System    EGS-Grafik-Libraries    8 Bit       8 / 24 Bit
  118.  
  119.  
  120.     Support :
  121.     =========
  122.  
  123.     Folgende Programme machen derzeit Gebrauch von der "superview.library" :
  124.  
  125.      - SuperView
  126.      - SimpleView (superview.library Beispiel-Programm)
  127.      - MicroView (superview.library Beispiel-Programm)
  128.      - KFracPlus
  129.      - DRAFU (unreleased Beta-Version)
  130.      - ...
  131.  
  132.  
  133.     Danke und Grüße an :
  134.     ====================
  135.  
  136.     in alphabetical order :)
  137.  
  138.     Alex    Carbin    (TuC / PowerBrei Red.)
  139.     Fred    Fish    (AmigaLibDisks)
  140.     Gerd    Frank    (BerndsPD)
  141.     Stefan  Grad    (GPD)
  142.     Stefan  Kremer    (TuC / PowerBrei Red.)
  143.     Alex    Lange    (Time PD-Serie)
  144.     H.P.    Lattka    (Franz PD-Serie)
  145.     Andreas Manewaldt    (Taifun PD-Serie)
  146.     Axel    Melzener    (Game Object Design)
  147.     Michael Petrikowski (Amiga Szene)
  148.     Steve   Quartly    (Australien)
  149.     Martin  Schulze    (SaarAG / AmiNet)
  150.  
  151.     und alle, die ich vergessen habe !
  152.  
  153.  
  154.     Korrespondenz :
  155.     ===============
  156.  
  157.     Wenn Sie wollen, können Sie mir etwas Geld senden. Sicherlich
  158.     wird mich das motivieren, weiterhin solche Programme zu schreiben
  159.     oder einfach Updates zu diesem zu erstellen.
  160.     Senden Sie bug-reports, Geld oder was-auch-immer an :
  161.  
  162.        Andreas R. Kleinert,
  163.        Grube Hohe Grethe 23,
  164.        D-57074 Siegen,
  165.        Germany.
  166.  
  167.  
  168.     Versions-Geschichte :
  169.     =====================
  170.  
  171.     Bitte beachten Sie die Versions-Abhängigkeiten :
  172.  
  173.     superview.library       SVObjects      SVDrivers     SVOperators
  174.  
  175.     Version 1           -          -         -
  176.     Version 2           Version 1      -         -
  177.     Version 3-6        Version 1,2      Version 1     -
  178.  
  179.  
  180.      V6.3 (06.06.1994) :
  181.      -------------------
  182.  
  183.       - kleinere Fehlerkorrekturen
  184.       - bei allen der beigefügten SVObjects mit Write-Support sind jetzt
  185.     auch die Flags für GfxBuffer-Support gesetzt
  186.  
  187.  
  188.      V6.2 (03.06.1994) :
  189.      -------------------
  190.  
  191.       - GIF.svobject in einigen Punkten verbessert
  192.       - TIFF.svobject überarbeitet und einige schlimme Fehler korrigiert
  193.     (außerdem Einbau einiger neuer Features, die bis jetzt noch nicht
  194.      großartig getestet wurden)
  195.       - idiotischen Fehler im ILBM.svobject korrigiert (betraf das
  196.     Speichern von Bildern mit ungeraden Breiten). Derselbe Fehler
  197.     ist wohl auch im ACBM.svobject, aber warum sollte ich es durch
  198.     die Korrektur inkompatibel mit älteren Versionen machen ?
  199.     Es könnten noch mehr solche "word-padding bugs" in anderen SVObjects
  200.     existieren, allerdings sind nicht in allen Fällen die Spezifi-
  201.     kationen der Fileformate so eindeutig, wie das bei IFF-ILBM der Fall
  202.     ist ...
  203.       - FAQ-ähnliche Dokumentation erstellt (NotesAndHints.guide), Englisch
  204.       - Beispiel-Programm "ReadGfxBuffer" entfernt, da dies seit V6.1
  205.     auch in "SimpleView"s Source-Code demonstriert wird
  206.  
  207.  
  208.      V6.1 (28.05.1994) :
  209.      -------------------
  210.  
  211.       - WICHTIGER BUGFIX : SVL_SetGfxBuffer() plus SVL_SuperWrite()
  212.                brach IMMER ab, was (wieder) durch einen sehr
  213.                simplen Fehler, nicht mal erwähnenswert,
  214.                verursacht wurde
  215.       - mit allen der beigefügten SVObjects mit Write-Support ist es jetzt
  216.     möglich, nicht nur Screens, sondern auch GfxBuffers abzuspeichern :
  217.     alle internen Write-Routinen wurden komplett neu geschrieben, so daß
  218.     übergebene Screens vor dem Abspeichern in GfxBuffers kopiert werden.
  219.     BitPlane UND OnePlane Buffer bis 8 Bit werden unterstützt : sie
  220.     werden ineinander konvertiert durch Verwendung der entsprechenden
  221.     Funktionen der superviewsupport.library V3+.
  222.       - diese große Verbesserung - daran habe ich seit Einführung von
  223.     superview.library V3+ gearbeitet - is der Grund, warum die Versions-
  224.     nummer auf 6 erhöht wurde !
  225.     Dieses Feature können Sie mit der beigefügten Version von SimpleView
  226.     oder mit SuperView V2.5+ einsetzen !
  227.       - vier neue Functionen für das simple Anlegen und Freigeben von
  228.     vereinfachten SVObject- und SVDriver-Listen wurden hinzugefügt.
  229.     Dies wird den Zugriff auf die Write-Funktionen der superview-Library
  230.     aus Applikationen heraus erheblich erleichtern !
  231.       - jetzt mit kompletter (reference-ähnlicher) Dokumentation für
  232.     SVObjects und SVDriver als solche
  233.       - ein JPEG.svobject ist seit V5.2 (separat) verfügbar
  234.       - und mehr ...
  235.  
  236.  
  237.      V5.2 (22.05.1994) :
  238.      -------------------
  239.  
  240.       - superviewsupport.library besitzt jetzt view neue Funktionen, die
  241.     dazu gedacht sind, die allgemeine Verwendung des neuen
  242.     "ControlPad-FileFormates für SVObject/SVDriver/... Konfigurations-
  243.     dateien" zu ermöglichen. (Siehe Docs/SVSupport-Docs)
  244.     Die Dateien entsprechen in etwa Tooltype-Listen.
  245.       - ein vollkommen FALSCHER Abschnitt wurde aus Reference_ENG.doc
  246.     entfernt, welcher die SVL_InitHandleAsClip() Funktion betraf
  247.     (der Vermerk bezog sich immer noch auf die nie veröffentlichte
  248.     Beta Version 3.9, die inkompatibel war)
  249.       - neues Targa.svobject mit 24 Bit-Support. Nur Lesen bis jetzt.
  250.       - fehlerkorrigierte und verbesserte version des 24 Bit-Supports im
  251.     PCX.svobject.
  252.       - leicht verbesserter AGA.svdriver (Beinahe-Bugfix)
  253.  
  254.  
  255.      V5.1 (18.05.1994) :
  256.      -------------------
  257.  
  258.       - WICHTIGER BUGFIX : SVL_ReadGfxBuffer() brach IMMER ab,
  259.                was durch einen sehr simplen Fehler, nicht
  260.                mal erwähnenswert, verursacht wurde
  261.                (Murphys Law ?)
  262.       - das Version-Checking der SVObjects für die Verwendung der
  263.     GfxBuffer-Functions war auch nicht ganz korrekt : es wurde auf
  264.     V3+ anstelle von V2+ geprüft
  265.       - Fehler im ACBM.svobject korrigiert
  266.       - einige Doc-Files korrigiert
  267.  
  268.  
  269.      V4.1 (15.05.1994) :
  270.      -------------------
  271.  
  272.       - wegen Spezifikationsänderung/erweiterung : Erhöhung auf V4
  273.       - neues MAC.svobject. Nur Lesen bis jetzt.
  274.       - jegliches NICHT-VON-DISK Lesen und Speichern, z.B. von/nach
  275.     ClipBoard FUNKTIONIERTE seit V2.4 NICHT MEHR.
  276.     Bevor ILBM.svobject und ACBM.svobject externalisiert wurden,
  277.     funktionierte dieses Feature zwar, aber nur mit eben diesen beiden.
  278.     Nach der Externalisierung (in dieser Version) wurde dieser Bug
  279.     entdeckt und beseitigt.
  280.     Die Spezifikation mußte dazu leicht geändert werden - auf eine
  281.     kompatible Art und Weise - um das LESEN wieder zum Laufen zu bringen
  282.     (siehe Reference_ENG.doc, SV_InitHandleAsClip-Funktion).
  283.     Für das SCHREIBEN mußte nur die superview-Library geändert werden.
  284.  
  285.  
  286.      V3.8 (12.05.1994) :
  287.      -------------------
  288.  
  289.       - Verwendung von SAS/C V6.51
  290.       - Erstellung der "superviewsupport.library", die von der
  291.     superview.library und allen beigefügten SVObjects und SVDrivern
  292.     verwendet wird.
  293.     Dies spart zwischen 500 und 1600 Bytes bei jedem svobject und
  294.     außerdem 1000 Bytes bei der superview.library.
  295.     superviewsupport.library selbst benötigt nur etwa 3000 Bytes, so
  296.     daß sich eine relativ große Einsparung ergibt.
  297.  
  298.  
  299.      V3.7 (01.05.1994) :
  300.      -------------------
  301.  
  302.       - Diese Version enthält alle "last minute bug-fixes" zu V3.6 und mehr
  303.       - verschiedene SVObjects erheblich verbessert : PCX, TIFF, ...
  304.       - verschiedene SVDriver  erheblich verbessert : EGS
  305.       - SuperViewPrefs leicht verbessert
  306.       - Installer-Script befähigt, "ENVARC:Default.svdriver" zu erzeugen :
  307.     Für Leute, die vergessen, SuperViewPrefs zu verwenden
  308.  
  309.  
  310.      V3.6 (18.04.1994) :
  311.      -------------------
  312.  
  313.       - Diese Version enthält alle "last minute bug-fixes" zu V3.5 und mehr
  314.       - neues TIFF.svobject. Nur Lesen bis jetzt.
  315.     (erste Version war bereits als Bug-Fix zu V3.5 enthalten)
  316.       - neues WPG.svobject. Nur Lesen bis jetzt.
  317.       - verschiedene SVObjects erheblich verbessert : IMG, TIFF, GIF, ...
  318.       - verschiedene SVDriver  erheblich verbessert : AGA, EGS
  319.       - 24 Bit-Support (ONEPLANE-RGB) in AGA- und EGS-SVDriver hinzugefügt
  320.  
  321.  
  322.      V3.5 (27.03.1994) :
  323.      -------------------
  324.  
  325.       - neues Beispiel-Programm : MicroView !
  326.       - Datatypes-Support jetzt nur noch für BILDER : alles andere wird
  327.     zurückgewiesen
  328.       - Include-Files spiegeln nun V3.5 wieder, diverse Veränderungen
  329.     wurden vorgenommen
  330.       - alle beigefügten SVObjects verfügen nicht länger über einen
  331.     internen Default-SVDriver : Das spart jeweils etwa 1600 Bytes
  332.     Diskettenspeicherplatz, der für zukünftige Erweiterungen
  333.     benötigt wird.
  334.       - SAS/C's sprintf()-Routine wurde durch eine eigene ersetzt, die
  335.     auf RawDoFmt() basiert.
  336.     Das spart nochmals ca. 1800 Bytes.
  337.       - die Utility-Library wird jetzt für Integer-Operationen verwendet
  338.     (SAS/C's UTILLIB-Option wurde aktiviert) : das vergrößert den
  339.     68000-Code etwas, führt jedoch zu Geschwindigkeitssteigerungen
  340.     auf 68020+ Systemen
  341.     (die Codegröße hätte sich eigentlich auch verringern sollen,
  342.      aber sie tat's halt nicht ...)
  343.  
  344.  
  345.      V3.4 (25.03.1994) :
  346.      -------------------
  347.  
  348.       - Diese Version enthält alle "last minute bug-fixes" zu V3.3 und mehr
  349.       - neues IMG.svobject (GEM). Nur Lesen bis jetzt.
  350.       - FBM.svobject (Unix) jetzt auch mit Write-Support.
  351.       - VIELE Veränderungen an ALLEN SVDrivern und SVObjects
  352.  
  353.  
  354.      V3.3 (22.03.1994) :
  355.      -------------------
  356.  
  357.       - Beispiel-Sources verbessert (SimpleView, ListSVOs, ListSVDs) :
  358.      - nicht länger abhängig von der "ak_gen0.library", überflüssigen
  359.        Code entfernt
  360.      - interne printf-Ersatzroutine verbessert
  361.       - neues FBM.svobject (Unix). Nur Lesen bis jetzt.
  362.       - LibID korrigiert : superview.library stammt nicht aus dem Jahr 2994,
  363.                sondern 1994 ;)
  364.  
  365.  
  366.      V3.2 (17.03.1994) :
  367.      -------------------
  368.  
  369.       - Diese Version enthält alle "last minute bug-fixes" zu V3.1 und mehr
  370.       - EGS.svdriver zur Distribution hinzugefügt (allererster Anfang einer
  371.     Unterstützung des EGS Grafiksystems, zur Zeit nur bis 8-Bit)
  372.       - neues C64.svobject (Koala, Doodle). Nur Lesen.
  373.     Das ist KEIN Scherz !
  374.  
  375.  
  376.      V3.1 (11.03.1994) :
  377.      -------------------
  378.  
  379.       - Beta-Versionen : V2.7
  380.     (Parameter-BugFix in SVO_SetWriteSubType() :
  381.      Pragmas initialisierten D1 anstelle von A2)
  382.       - Einführung der SVDrivers
  383.       - kleiner Fehler in den "memory management"-Routinen korrigiert
  384.       - verschiedene wichtige Korrekturen und Verbesserungen in
  385.     den Version2-SVObjects
  386.       - BugFix in superview.library :
  387.     ein Aufruf von SVL_WindowIDCMP, SVL_WindowFlags oder SVL_ScreenType
  388.     ergab Default-Werte, falls ein externes SVObject verwendet wurde
  389.     (hatte vergessen, diese Werte innerhalb von SVL_SuperView nochmals
  390.     für das SVObject zu setzen)
  391.       - V39-DataType-Anzeige jetzt mit den richtigen Farben
  392.       - mehr und detailliertere Informationen über V39-DataTypes
  393.       - alle derzeit enthaltenen SVObjects (außer DataTypes) erlauben jetzt
  394.     Lesen (in Screen oder Buffer) und Schreiben (von Screen) der
  395.     Grafiken
  396.  
  397.  
  398.      V2.6 (13.02.1994) :
  399.      -------------------
  400.  
  401.       - kleinere Verbesserungen
  402.  
  403.  
  404.      V2.5 (24.01.1994) :
  405.      -------------------
  406.  
  407.       - neues BMP.svobject (nur Lesen)
  408.       - diverse Verbesserungen
  409.  
  410.  
  411.      V2.4 (22.01.1994) :
  412.      -------------------
  413.  
  414.       - Rekompilierung : Verwendung von SAS/C V6.5
  415.       - wieder : Fehlerkorrektur in SVL_FreeHandle(),
  416.          externe SVObjects wurden NIE geschlossen
  417.       - IFF-ILBM und IFF-ACBM als ILBM.svobject und
  418.     ACBM.svobject "externalisiert"
  419.  
  420.  
  421.      V2.3 (16.01.1994) :
  422.      -------------------
  423.  
  424.       - erhöhte Geschwindigkeit beim Schreiben von IFF-ILBM und IFF-ACBM
  425.       - Fehler in SVL_FreeHandle() korrigiert : nicht SVO_FreeHandle()
  426.     wurde aufgerufen, sondern SVO_CloseDisplay() und SVO_FreeResources()
  427.       - Fehler in den Includes korrigiert (war manchmal APTR * anstelle
  428.     von APTR)
  429.  
  430.  
  431.      V2.2 :
  432.      ------
  433.  
  434.       - neues GIF.svobject (bis GIF89a, nur lesen)
  435.       - erhöhte Geschwindigkeit beim Lesen von IFF-ILBM und IFF-ACBM
  436.  
  437.  
  438.      V2.1 :
  439.      ------
  440.  
  441.       - Beta-Versionen : V1.2, V1.3
  442.       - Einführung der svobjects
  443.       - Library darf von jedem für jeden Zweck verwendet werden
  444.       - komplette interne Überarbeitung
  445.       - DataType-Support integriert (read-only)
  446.       - Fehler in der ScreenMode Validation Routine für IFF-ILBM/-ACBM
  447.     korrigiert
  448.       - neue "Best ScreenMode"-Routine für IFF-ILBM/-ACBM und PCX.svobject
  449.     (unterschiedliche Ergebnisse für OS V37+ und OS V39+)
  450.       - neues PCX.svobject
  451.       - neues SVO.svobject plus SourceCode
  452.  
  453.  
  454.      V1.1 :
  455.      ------
  456.  
  457.       - Erste Version. FREEWARE.
  458.  
  459.  
  460.     Copyrights :
  461.     ============
  462.  
  463.     Einige der oben genannten Namen oder Produkte können Copyrights oder
  464.     Warenzeichen von Firmen sein.
  465.  
  466.  
  467.